home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games: Greatest Hits 1996 / Amiga Games: Greatest Hits 1996.iso / archive / userbox / publicdomain / dctv-viewer.lha / DCTV-Viewer / DCTV-Viewer.txt < prev    next >
Text File  |  1996-07-22  |  12KB  |  298 lines
  1.                              DCTV Viewer 1996!
  2.  
  3.               Not to be mistaken by Windows95 (95% data loss)
  4.  
  5.                               By Alex Howell
  6.  
  7.                          BYTE BUiLDERS INDUSTRIES
  8.  
  9.                    We don't write software, we build it.
  10.  
  11.  
  12. Please take time and read over the documentation that's contained within
  13. this file, as it is simple, it is quite important and well worth the
  14. reading.
  15.  
  16. -----------------------------------------------------------------------------
  17.  
  18. Contact me at Snailmail:    2546 Constable Road
  19.                             Mississauga, Ontario
  20.                             L5J-1W2
  21.  
  22. I sometimes am on IRC in #amiga, you can say hi to me there, I am GuruSR.
  23.  
  24. Feel like dropping me a line, I'd like to hear from you, as I have plans on
  25. an OS friendly adaptation, but would prefer to find out how many of you out
  26. there REALLY want such.  And if you like using the viewer, and are rich! 
  27. Hey, share!  :)
  28.  
  29. -----------------------------------------------------------------------------
  30.  
  31. My "Disclaimer":
  32.  
  33. I guarantee it works (except 1.3 with an 68030 seemed flakey but it does
  34. anyways, I need to find the right Setpatch for it).
  35.  
  36. I guarantee it can't crash hard drives.  (Why?  Because it's a reader, not a
  37. writer, all it *DOES* save, is a small 512 byte-ish config in S:.  Okay,
  38. mine is 66 byes long but hey, it can get longer.)
  39.  
  40. I don't guarantee that it'll be fast on 68000 machines, but it WORKS.  :)
  41.  
  42. -----------------------------------------------------------------------------
  43.  
  44. DCTV Viewer's "Overview":
  45.  
  46. The idea was, got a real nice picture, BUT, you can only see a small copy of
  47. it, on a normal screen, don't have a 24 bit card, BUT, you DO have a DCTV! 
  48. But, all of the current DCTV JPEG/GIF viewers DON'T scroll!  So, what I did
  49. was make something that viewed ".DCTV" files.  Which are basically,
  50. `DCTV DISPLAY' files.  Ones that you convert to DCTV with programs like
  51. "HamLab", "ImageFX", "ArtDepartment Pro" and there must be others.  Just
  52. convert the picture right over and save it as a .DCTV file and then run the
  53. viewer.  :)  And enjoy!  :)
  54.  
  55. Oh yes, RTFM!  :)
  56.  
  57. -----------------------------------------------------------------------------
  58.  
  59. The file selection screen.  ("File Selector")
  60.  
  61. There are two boxes of concern to you, when using this screen, the largest
  62. being where files and devices/assigns will show up within, and the smaller
  63. one below it, which will display the current path or current pattern.
  64.  
  65.          ============================================================
  66.          |                                                          |
  67.          | ========================================        GETDIR   |
  68.          | |                                      |                 |
  69.          | | Files and Devices/Assigns are shown  |  _     PARENT   |
  70.          | | here.  To select directories or      |  ^              |
  71.          | | Devices/Assigns, double click with   |         VIEW    |
  72.          | | your left mouse button.  Selecting   |  ^              |
  73.          | | files need only one click.  Clicking |        SELECT   |
  74.          | | with right mouse button over this    |  v              |
  75.          | | window will swap the listing to/from |        CLEAR    |
  76.          | | Files and Devices/Assigns.           |  v              |
  77.          | |                                      |  ~     PATTERN  |
  78.          | | See documentation for RANGE selects. |                 |
  79.          | |                                      |        CLOSE    |
  80.          | ========================================                 |
  81.          |                                                          |
  82.          | ========================================                 |
  83.          | |   Path and Pattern shown here  *B*   |                 |
  84.          | ========================================                 |
  85.          |                                                          |
  86.          ============================================================
  87.  
  88. *B*  To use this window, you can do a few things:  click on the "PATTERN"
  89. button or click on the actual window to edit the currently displayed
  90. information.
  91.  
  92. The current path or pattern can be seen by clicking the RIGHT mouse button
  93. over top the window.  It will swap the display inside that window for
  94. whichever of the two isn't being displayed when you click.
  95.  
  96.  
  97. To select a file or multiple files:
  98.  
  99. Clicking once on a file inside the Files and Devices/Assign window, with the
  100. LEFT mouse button will toggle a highlight on it.  
  101.  
  102. Clicking the RIGHT mouse button will toggle between Files and Devices/Assigns
  103. being displayed within this window.  The MIDDLE mouse button is used to
  104. select a RANGE.  Simply select two pictures and then click the MIDDLE mouse
  105. button and the range will either select or clear the range, depending on the
  106. last selection's state.  *IF* you don't have a 3 button mouse, don't fret! 
  107. You can simply hold down the LEFT mouse on the second selected file that ends
  108. the range, and click the RIGHT one, while still holding down the left one (a
  109. left-hold and right click).  Then the range will be selected.
  110.  
  111. Another way would be to select files by changing the pattern and hitting
  112. either select or clear to make changes.  Though this affects the entire list
  113. of files, you might want to hit GETDIR instead.  That will read in according
  114. to the pattern you selected.
  115.  
  116. NOTE:  Selected files don't disappear after viewing.  You must clear them    
  117.        out yourself.  Typically, this is not a problem.
  118.  
  119. Selecting volumes is as simple as double clicking on the volume or assign in
  120. the list.  The same method is used to enter directories.
  121.  
  122. NOTE:  In the event that there aren't any files readable with the current
  123.        pattern, changing the pattern when there are NO files listed, will
  124.        cause the viewer to re-read the directory whenever you change the
  125.        pattern.
  126.  
  127. -----------------------------------------------------------------------------
  128. Buttons:
  129.  
  130.  
  131. "GETDIR"
  132.  
  133. This button re-reads the current path.  IF the pattern is changed and NO
  134. files are on the list, getdir automatically tries again.
  135.  
  136.  
  137. "PARENT"
  138.  
  139. This button will back out one directory entry.  If at the actual device
  140. name, you'll be presented with the device/assign list (which can also be
  141. gotten with the right mouse button over the file list area).
  142.  
  143.  
  144. "VIEW"
  145.  
  146. View with the left mouse button will view the currently selected files,
  147. the right mouse button will continue to view the selected files past the
  148. last one previously viewed (the next picture after the currently displayed
  149. one, which was seen after aborting the list of selected files).
  150.  
  151.  
  152. "SELECT"
  153.  
  154. Select uses the current pattern to select only those files that match it.
  155.  
  156.  
  157. "CLEAR"
  158.  
  159. Clear uses the current pattern to clear only those files that match it.
  160.  
  161.  
  162. "PATTERN"
  163.  
  164. Pattern allows you to change the current pattern, as opposed to actually
  165. clicking the right mouse button over the directory path box and clicking
  166. in it.  Once you've edited the pattern, the directory will return if it
  167. was being shown.  Only valid paths will remain, if an invalid path is
  168. entered, it will return to normal.  ESC will abort the current text being
  169. edited and the original text will be replaced.
  170.  
  171. "CLOSE"
  172.  
  173. This will cause the DCTV-Viewer to save it's defaults in the S: directory
  174. and exit.  If the S: path is write-protected, it will not save the
  175. defaults, it will simply exit.
  176.  
  177.  
  178. -----------------------------------------------------------------------------
  179.  
  180. Keyboard Configurations:
  181.  
  182.  
  183. Using the keyboard, you can alter the current viewer's setup, as follows:
  184.  
  185.  
  186. Visual Display:
  187.  
  188. Amiga Key + Cursor Keys:
  189.  
  190.  These will alter the size of the display, just experiment while a picture
  191.  is onscreen.  (This only affects the picture display area only and cannot
  192.  be done after you've moved into a picture.  See "INFO BOX".)
  193.  
  194. ALT Key + Cursor Keys:
  195.  
  196.  These will allow the visual area to be properly aligned to the top left
  197.  hand corner of your monitor.  Do the actual picture display area FIRST, then
  198.  you can move the file requestor screen accordingly, as moving the  picture
  199.  display around, *WILL* affect the file requestor screen.  Experiment with
  200.  this and get the results you want.
  201.  
  202. NOTE:  Some blitters MAY have troubles with your screen positioning, some
  203.        may not.  If an image disappears or an image goes bad, reposition
  204.        OR resize your view to make the blitter happy.  (Blitter is that
  205.        chip in your Amiga called an Agnus and is responsible for moving
  206.        graphics.)
  207.  
  208. If you own a computer with a numeric keypad (Sorry A600 owners, but I
  209. seriously doubt you'd be using this program anyways), the following keys
  210. on that keypad allow you to control the "BEEPS" you hear while using the
  211. Viewer.  These ALWAYS work, in all areas of the viewer's usage, except
  212. during some text input.
  213.  
  214.  
  215. Key "*":
  216.  
  217.  This key will toggle the BEEPS On and Off, default is On.
  218.  
  219. Key "-":
  220.  
  221.  This key drops the volume of the BEEPS down by one.
  222.  
  223. Key "+":
  224.  
  225.  This key drops the volume of the BEEPS up by one.
  226.  
  227. Keys 0-9:
  228.  
  229.  These keys turn on the TURBO (yup, like your real life car in the
  230.  driveway).  0 is off, 9 is 9x's.  (Warp 9 anyone?)  Preferrably 1 for
  231.  the new C= mice, 2 for the old C= ones.
  232.  
  233. -----------------------------------------------------------------------------
  234.  
  235. Picture Viewing:
  236.  
  237. Scroll the screen about with the mouse, clicking the LEFT mouse button will
  238. display the "Info Box" at the bottom of your screen.
  239.  
  240. See "Info Box" usage for more information on that box.
  241.  
  242. To exit the "Info Box", click the LEFT mouse button again.  (Holding the
  243. LEFT mouse button down will show the "Info Box" only until you let go of the
  244. LEFT mouse button.)
  245.  
  246. To select/move to the next picture, press the RIGHT mouse button, when
  247. either the "Info Box" is up or just while the picture is.
  248.  
  249. -----------------------------------------------------------------------------
  250.  
  251. "Info Box" Usage:
  252.  
  253. The Info Box is to display all the information about the current picture
  254. being viewed.  As well if the current picture being viewed is larger than
  255. the area being seen a box will show up within the right White Box area.
  256.  
  257. The White Box area shows up when your visual area is smaller than the
  258. actual full picture.  Simply cursor around and then press the RIGHT mouse
  259. button to `GO ON' to the next part of the image.  Pressing the LEFT mouse
  260. button will abort this and exit out of the Info Box.
  261.  
  262. -----------------------------------------------------------------------------
  263.  
  264. Features:
  265.  
  266. If the visual (Chip memory) isn't large enough to accomodate the current
  267. `Visual Area' (Screen display area), it will shrink the screen down in size,
  268. until there's enough Chip memory to open the screen.
  269.  
  270. Pictures Auto-Center.  With them only centering horizontally when the
  271. "Info Box" is open.
  272.  
  273. `Smart Screen' (no tm but it's fun) is a method of REUSING a currently
  274. opened screen (Screen display area), rather than closing and reopening one
  275. that's simular and could fit the next picture within.  This helps cut down
  276. on memory fragmentation and also helps speed up the displaying process.
  277.  
  278. `Smart Reselect' will not reload the next picture viewed, IF the same
  279. picture is selected as the next picture to see after the File Selector was
  280. used.  IE:  You select Picture A, then some others and select View, from the
  281. File Selector.  Yet Picture A was the last one you were looking at before
  282. the File Selector came up.  It won't re-load Picture A since it's already
  283. there.
  284.  
  285. -----------------------------------------------------------------------------
  286.  
  287. Memory Problems:
  288.  
  289. In the event, a screen can't be opened due to memory limitations (Chip mem
  290. is so frazzled there's not a nibble left), a requestor will hopefully pop up
  291. telling you it couldn't view the picture because it couldn't load it. 
  292. You'll have two choices, IGNORE or INFORM.  With the ALWAYS button down, it
  293. will always do those two items.
  294.  
  295. NOTE:  INFORM doesn't do anything without the ALWAYS button down.
  296.  
  297. ------------------------------------------------------------------------------
  298.